home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / myles177.arc / LESS.MAN < prev    next >
Text File  |  1991-09-04  |  44KB  |  1,123 lines

  1.  
  2.  
  3. LESS(1)             Unix Programmer's Manual              LESS(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      less - opposite of more
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      llleeessssss ---???
  11.      llleeessssss [[[-[[[+++]]]aaaBBBcccCCCdddeeeEEEfffHHHiiimmmMMMnnnNNNqqqQQQrrrsssSSSuuuUUUwww]]]
  12.           [[[-bbb _b_u_f_s]]] [[[-hhh _l_i_n_e_s]]] [[[-jjj _l_i_n_e]]] [[[-kkk _k_e_y_f_i_l_e]]]
  13.           [[[-{{{oooOOO}}} _l_o_g_f_i_l_e]]] [[[-ppp _p_a_t_t_e_r_n]]] [[[-PPP _p_r_o_m_p_t]]] [[[-ttt _t_a_g]]]
  14.           [[[-TTT _t_a_g_f_i_l_e]]] [[[-xxx _t_a_b]]] [[[-yyy _l_i_n_e_s]]] [[[-[[[zzz]]] _l_i_n_e_s]]]
  15.           [[[+++[[[+++]]]_c_m_d]]] [[[_f_i_l_e_n_a_m_e]]].........
  16.  
  17.  
  18. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  19.      _L_e_s_s is a program similar to  _m_o_r_e  (1),  but  which  allows
  20.      backward  movement  in the file as well as forward movement.
  21.      Also, _l_e_s_s does not have  to  read  the  entire  input  file
  22.      before  starting,  so  with  large  input files it starts up
  23.      faster than text editors like _v_i (1).  _L_e_s_s uses termcap (or
  24.      terminfo  on  some  systems),  so it can run on a variety of
  25.      terminals.  There  is  even  limited  support  for  hardcopy
  26.      terminals.   (On  a hardcopy terminal, lines which should be
  27.      printed at the top of the screen are prefixed  with  an  up-
  28.      arrow.)
  29.  
  30.      Commands are based on both _m_o_r_e  and  _v_i.  Commands  may  be
  31.      preceded  by  a decimal number, called N in the descriptions
  32.      below.  The number is used by some commands, as indicated.
  33.  
  34.  
  35. CCCOOOMMMMMMAAANNNDDDSSS
  36.      In the following  descriptions,  ^X  means  control-X.   ESC
  37.      stands  for  the ESCAPE key; for example ESC-v means the two
  38.      character sequence "ESCAPE", then "v".
  39.  
  40.      h or H
  41.           Help: display a summary  of  these  commands.   If  you
  42.           forget all the other commands, remember this one.
  43.  
  44.      SPACE or ^V or f or ^F
  45.           Scroll forward N lines, default one window (see  option
  46.           -z below).  If N is more than the screen size, only the
  47.           final screenful is displayed.   Warning:  some  systems
  48.           use ^V as a special literalization character.
  49.  
  50.      z    Like SPACE, but if N is specified, it becomes  the  new
  51.           window size.
  52.  
  53.      RETURN or ^N or e or ^E or j or ^J
  54.           Scroll forward N lines, default 1.  The entire N  lines
  55.           are displayed, even if N is more than the screen size.
  56.  
  57.      d or ^D
  58.           Scroll forward N lines, default one half of the  screen
  59.           size.   If  N  is specified, it becomes the new default
  60.           for subsequent d and u commands.
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69. LESS(1)             Unix Programmer's Manual              LESS(1)
  70.  
  71.  
  72.      b or ^B or ESC-v
  73.           Scroll backward N lines, default one window (see option
  74.           -z below).  If N is more than the screen size, only the
  75.           final screenful is displayed.
  76.  
  77.      w    Like ESC-v, but if N is specified, it becomes  the  new
  78.           window size.
  79.  
  80.      y or ^Y or ^P or k or ^K
  81.           Scroll backward N lines, default 1.  The entire N lines
  82.           are  displayed, even if N is more than the screen size.
  83.           Warning: some systems use ^Y as a special  job  control
  84.           character.
  85.  
  86.      u or ^U
  87.           Scroll backward N lines, default one half of the screen
  88.           size.   If  N  is specified, it becomes the new default
  89.           for subsequent d and u commands.
  90.  
  91.      r or ^R or ^L
  92.           Repaint the screen.
  93.  
  94.      R    Repaint the  screen,  discarding  any  buffered  input.
  95.           Useful  if  the  file  is  changing  while  it is being
  96.           viewed.
  97.  
  98.      F    Scroll forward, and keep trying to read when the end of
  99.           file  is  reached.  Normally this command would be used
  100.           when already at the end of the file.  It is  a  way  to
  101.           monitor the tail of a file which is growing while it is
  102.           being viewed.  (The behavior is similar  to  the  "tail
  103.           -f" command.)
  104.  
  105.      g or < or ESC-<
  106.           Go to line N in  the  file,  default  1  (beginning  of
  107.           file).  (Warning: this may be slow if N is large.)
  108.  
  109.      G or > or ESC->
  110.           Go to line N in the file, default the end of the  file.
  111.           (Warning:  this  may  be slow if N is large, or if N is
  112.           not specified and standard input, rather than  a  file,
  113.           is being read.)
  114.  
  115.      p or %
  116.           Go to a position N percent into the file.  N should  be
  117.           between  0  and  100.  (This works if standard input is
  118.           being read, but only if _l_e_s_s has already  read  to  the
  119.           end  of  the  file.   It is always fast, but not always
  120.           useful.)
  121.  
  122.      {    If a  left  curly  bracket  appears  in  the  top  line
  123.           displayed  on  the screen, the { command will go to the
  124.           matching right curly bracket.  The matching right curly
  125.           bracket is positioned on the bottom line of the screen.
  126.           If there is more than one left curly bracket on the top
  127.           line,  a  number  N  may  be  used  to specify the N-th
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135. LESS(1)             Unix Programmer's Manual              LESS(1)
  136.  
  137.  
  138.           bracket on the line.
  139.  
  140.      }    If a right curly bracket appears  in  the  bottom  line
  141.           displayed  on  the screen, the } command will go to the
  142.           matching left curly bracket.  The matching  left  curly
  143.           bracket  is  positioned  on the top line of the screen.
  144.           If there is more than one right curly  bracket  on  the
  145.           top  line,  a  number N may be used to specify the N-th
  146.           bracket on the line.
  147.  
  148.      (    Like {, but applies to parentheses  rather  than  curly
  149.           brackets.
  150.  
  151.      )    Like }, but applies to parentheses  rather  than  curly
  152.           brackets.
  153.  
  154.      [    Like {, but applies  to  square  brackets  rather  than
  155.           curly brackets.
  156.  
  157.      ]    Like }, but applies  to  square  brackets  rather  than
  158.           curly brackets.
  159.  
  160.      ESC-^F
  161.           Followed by two characters, acts like {, but  uses  the
  162.           two    characters   as   open   and   close   brackets,
  163.           respectively.  For example, "ESC ^F < >" could be  used
  164.           to  go  forward to the > which matches the < in the top
  165.           displayed line.
  166.  
  167.      ESC-^B
  168.           Followed by two characters, acts like }, but  uses  the
  169.           two    characters   as   open   and   close   brackets,
  170.           respectively.  For example, "ESC ^B < >" could be  used
  171.           to  go  backward  to  the  < which matches the > in the
  172.           bottom displayed line.
  173.  
  174.      m    Followed by any lowercase  letter,  marks  the  current
  175.           position with that letter.
  176.  
  177.      '    (Single quote.)   Followed  by  any  lowercase  letter,
  178.           returns  to  the  position  which was previously marked
  179.           with that letter.  Followed by  another  single  quote,
  180.           returns  to  the  position  at  which  the last "large"
  181.           movement command was executed.  Followed by a ^  or  $,
  182.           jumps to the beginning or end of the file respectively.
  183.           Marks are preserved when a new file is examined, so the
  184.           ' command can be used to switch between input files.
  185.  
  186.      ^X^X Same as single quote.
  187.  
  188.      /pattern
  189.           Search forward in the file for the N-th line containing
  190.           the  pattern.   N  defaults  to  1.   The  pattern is a
  191.           regular expression, as recognized  by  _e_d.  The  search
  192.           starts at the second line displayed (but see the -a and
  193.           -j options, which change this).
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.  
  200.  
  201. LESS(1)             Unix Programmer's Manual              LESS(1)
  202.  
  203.  
  204.           Certain  characters  are  special  if  entered  at  the
  205.           beginning  of  the  pattern;  they  modify  the type of
  206.           search rather than become part of the pattern:
  207.  
  208.      !    Search for lines which do NOT match the pattern.
  209.  
  210.      *    Search multiple files.  That is, if the search  reaches
  211.           the  end  of  the current file without finding a match,
  212.           the search continues in the next file  in  the  command
  213.           line list.
  214.  
  215.      @    Begin the search at the first line of the first file in
  216.           the  command line list, regardless of what is currently
  217.           displayed on the screen or the settings of the -a or -j
  218.           options.
  219.  
  220.      ?pattern
  221.           Search  backward  in  the  file  for  the   N-th   line
  222.           containing  the pattern.  The search starts at the line
  223.           immediately before the top line displayed.
  224.  
  225.           Certain characters are special as in the / command:
  226.  
  227.      !    Search for lines which do NOT match the pattern.
  228.  
  229.      *    Search multiple files.  That is, if the search  reaches
  230.           the  beginning  of  the  current file without finding a
  231.           match, the search continues in the previous file in the
  232.           command line list.
  233.  
  234.      @    Begin the search at the last line of the last  file  in
  235.           the  command line list, regardless of what is currently
  236.           displayed on the screen or the settings of the -a or -j
  237.           options.
  238.  
  239.      ESC-/pattern
  240.           Same as "/*".
  241.  
  242.      ESC-?pattern
  243.           Same as "?*".
  244.  
  245.      n    Repeat previous search, for N-th  line  containing  the
  246.           last  pattern.   If the previous search was modified by
  247.           !, the search is made for the N-th line NOT  containing
  248.           the pattern.  If the previous search was modified by *,
  249.           the search continues in the next (or previous) file  if
  250.           not  satisfied in the current file.  There is no effect
  251.           if the previous search was modified by @.
  252.  
  253.      N    Repeat previous search, but in the reverse direction.
  254.  
  255.      ESC-n
  256.           Repeat previous search, but crossing  file  boundaries.
  257.           The  effect  is as if the previous search were modified
  258.           by *.
  259.  
  260.  
  261.  
  262.                                                                 4
  263.  
  264.  
  265.  
  266.  
  267. LESS(1)             Unix Programmer's Manual              LESS(1)
  268.  
  269.  
  270.      ESC-N
  271.           Repeat previous search, but in  the  reverse  direction
  272.           and crossing file boundaries.
  273.  
  274.      :e [filename]
  275.           Examine a new file.  If the filename  is  missing,  the
  276.           "current"  file (see the :n and :p commands below) from
  277.           the list of files in the command line  is  re-examined.
  278.           A  percent  sign (%) in the filename is replaced by the
  279.           name of the current file. A pound sign (#) is  replaced
  280.           by  the  name  of  the  previously  examined file.  The
  281.           filename is inserted into  the  command  line  list  of
  282.           files  so  that  it can be seen by subsequent :n and :p
  283.           commands.  If the filename consists of  several  files,
  284.           they  are  all  inserted into the list of files and the
  285.           first one is examined.
  286.  
  287.      ^X^V or E
  288.           Same as :e.  Warning: some systems use ^V as a  special
  289.           literalization character.
  290.  
  291.      :n   Examine the next file (from the list of files given  in
  292.           the  command line).  If a number N is specified, the N-
  293.           th next file is examined.
  294.  
  295.      :p   Examine the previous file in the command line list.  If
  296.           a  number  N  is  specified,  the N-th previous file is
  297.           examined.
  298.  
  299.      :x   Examine the first file in the command line list.  If  a
  300.           number  N  is  specified,  the N-th file in the list is
  301.           examined.
  302.  
  303.      = or ^G or :f
  304.           Prints some information about the  file  being  viewed,
  305.           including  its name and the line number and byte offset
  306.           of the bottom line being displayed.   If  possible,  it
  307.           also prints the length of the file, the number of lines
  308.           in the file and the percent of the file above the  last
  309.           displayed line.
  310.  
  311.      -    Followed by one of the command line option letters (see
  312.           below), this will change the setting of that option and
  313.           print a message describing the  new  setting.   If  the
  314.           option  letter  has a numeric value (such as -b or -h),
  315.           or a string value (such as -P or -t), a new  value  may
  316.           be entered after the option letter.  If no new value is
  317.           entered, a message describing the  current  setting  is
  318.           printed and nothing is changed.
  319.  
  320.      -+   Followed by one of the command line option letters (see
  321.           below),  this  will  reset  the  option  to its default
  322.           setting and print a message describing the new setting.
  323.           (The  "-+_X" command does the same thing as "-+_X" on the
  324.           command line.)  This does not  work  for  string-valued
  325.           options.
  326.  
  327.  
  328.                                                                 5
  329.  
  330.  
  331.  
  332.  
  333. LESS(1)             Unix Programmer's Manual              LESS(1)
  334.  
  335.  
  336.      --   Followed by one of the command line option letters (see
  337.           below), this will reset the option to the "opposite" of
  338.           its default setting and print a message describing  the
  339.           new setting.  (The "--_X" command does the same thing as
  340.           "-_X" on the command line.)   This  does  not  work  for
  341.           numeric or string-valued options.
  342.  
  343.      _    (Underscore.)  Followed by  one  of  the  command  line
  344.           option  letters  (see below), this will print a message
  345.           describing the current setting  of  that  option.   The
  346.           setting of the option is not changed.
  347.  
  348.      +cmd Causes the specified cmd to be executed each time a new
  349.           file  is  examined.   For  example,  +G  causes _l_e_s_s to
  350.           initially display each file starting at the end  rather
  351.           than the beginning.
  352.  
  353.      V    Prints the version number of _l_e_s_s being run.
  354.  
  355.      q or :q or :Q or ZZ or ESC ESC
  356.           Exits _l_e_s_s.
  357.  
  358.      The following three  commands  may  or  may  not  be  valid,
  359.      depending on your particular installation.
  360.  
  361.      v    Invokes an  editor  to  edit  the  current  file  being
  362.           viewed.   The  editor  is  taken  from  the environment
  363.           variable EDITOR, or defaults to  "vi".   See  also  the
  364.           discussion  of  LESSEDIT  under  the section on PROMPTS
  365.           below.
  366.  
  367.      ! shell-command
  368.           Invokes a shell to  run  the  shell-command  given.   A
  369.           percent sign (%) in the command is replaced by the name
  370.           of the current file. A pound sign (#)  is  replaced  by
  371.           the name of the previously examined file.  "!!" repeats
  372.           the last shell command.   "!"  with  no  shell  command
  373.           simply  invokes  a  shell.   In all cases, the shell is
  374.           taken from the environment variable SHELL, or  defaults
  375.           to "sh".
  376.  
  377.      | <m> shell-command
  378.           <m> represents any mark letter.  Pipes a section of the
  379.           input  file to the given shell command.  The section of
  380.           the file to be piped is between the first line  on  the
  381.           current  screen  and the position marked by the letter.
  382.           <m> may also be ^ or $ to indicate beginning or end  of
  383.           file respectively.  If <m> is . or newline, the current
  384.           screen is piped.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                                                 6
  395.  
  396.  
  397.  
  398.  
  399. LESS(1)             Unix Programmer's Manual              LESS(1)
  400.  
  401.  
  402. OOOPPPTTTIIIOOONNNSSS
  403.      Command line options are described below.  Most options  may
  404.      be changed while _l_e_s_s is running, via the "-" command.
  405.  
  406.      Options are also taken from the environment variable "LESS".
  407.      For  example,  to avoid typing "less -options ..." each time
  408.      _l_e_s_s is invoked, you might tell _c_s_h:
  409.  
  410.      setenv LESS "-options"
  411.  
  412.      or if you use _s_h:
  413.  
  414.      LESS="-options"; export LESS
  415.  
  416.      The environment variable is parsed before the command  line,
  417.      so  command  line  options  override  the  LESS  environment
  418.      variable.  If an option appears in the LESS variable, it can
  419.      be reset to its default on the command line by beginning the
  420.      command line option with "-+".
  421.  
  422.      A dollar sign ($) may be used to signal the end of an option
  423.      string.   This  is  important only for options like -P which
  424.      take a following string.
  425.  
  426.      -?   This option displays a summary of the commands accepted
  427.           by _l_e_s_s (the same as the h command).  If this option is
  428.           given, all other options are ignored,  and  _l_e_s_s  exits
  429.           after  the  help  screen  is viewed.  (Depending on how
  430.           your shell interprets the  question  mark,  it  may  be
  431.           necessary to quote the question mark, thus: "-\?".)
  432.  
  433.      -a   Causes searches to start after the last line  displayed
  434.           on the screen, thus skipping all lines displayed on the
  435.           screen.  By default, searches start at the second  line
  436.           on the screen (or after the last found line; see the -j
  437.           option).
  438.  
  439.      -b_n  Causes _l_e_s_s to use a non-standard  number  of  buffers.
  440.           Buffers  are  1K,  and  by  default 10 buffers are used
  441.           (except if data in coming from standard input; see  the
  442.           -B  option).  The number _n specifies a different number
  443.           of buffers to use.
  444.  
  445.      -B   Disables automatic allocation of buffers, so that  only
  446.           the  default  number of buffers are used.  If more data
  447.           is read than will fit in the buffers, the  oldest  data
  448.           is  discarded.   By  default,  when data is coming from
  449.           standard input, buffers are allocated automatically  as
  450.           needed to avoid loss of data.
  451.  
  452.      -c   Causes full screen repaints to be painted from the  top
  453.           line  down.   By default, full screen repaints are done
  454.           by scrolling from the bottom of the screen.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                                                 7
  461.  
  462.  
  463.  
  464.  
  465. LESS(1)             Unix Programmer's Manual              LESS(1)
  466.  
  467.  
  468.      -C   The -C option is like -c, but  the  screen  is  cleared
  469.           before it is repainted.
  470.  
  471.      -d   The -d option suppresses  the  error  message  normally
  472.           displayed  if the terminal is dumb; that is, lacks some
  473.           important capability, such as the ability to clear  the
  474.           screen  or  scroll  backward.   The  -d option does not
  475.           otherwise  change  the  behavior  of  _l_e_s_s  on  a  dumb
  476.           terminal).
  477.  
  478.      -e   Causes _l_e_s_s to automatically exit the  second  time  it
  479.           reaches  end-of-file.  By default, the only way to exit
  480.           _l_e_s_s is via the "q" command.
  481.  
  482.      -E   Causes _l_e_s_s to automatically exit  the  first  time  it
  483.           reaches end-of-file.
  484.  
  485.      -f   Forces non-regular files to be opened.  (A  non-regular
  486.           file  is  a  directory or a device special file.)  Also
  487.           suppresses the warning message when a  binary  file  is
  488.           opened.   By  default,  _l_e_s_s  will  refuse to open non-
  489.           regular files.
  490.  
  491.      -h_n  Specifies a maximum number of lines to scroll backward.
  492.           If  it  is  necessary  to  scroll  backward more than _n
  493.           lines, the screen is repainted in a  forward  direction
  494.           instead.  (If the terminal does not have the ability to
  495.           scroll backward, -h0 is implied.)
  496.  
  497.      -i   Causes searches to ignore case; that is, uppercase  and
  498.           lowercase  are  considered identical.  Also, text which
  499.           is overstruck or underlined can be searched for.   This
  500.           option  is  ignored  if any uppercase letters appear in
  501.           the search pattern.
  502.  
  503.      -j_n  Specifies a line on the screen where "target" lines are
  504.           to  be positioned.  Target lines are the object of text
  505.           searches, tag searches, jumps to a line  number,  jumps
  506.           to  a  file percentage, and jumps to a marked position.
  507.           The screen line is specified by a number: the top  line
  508.           on  the  screen  is  1,  the next is 2, and so on.  The
  509.           number may be negative to specify a  line  relative  to
  510.           the bottom of the screen: the bottom line on the screen
  511.           is -1, the second to the bottom is -2, and so  on.   If
  512.           the  -j  option  is  used,  searches  begin at the line
  513.           immediately after the target line.  For example, if  "-
  514.           j4"  is used, the target line is the fourth line on the
  515.           screen, so searches begin at  the  fifth  line  on  the
  516.           screen.
  517.  
  518.      -k_f_i_l_e_n_a_m_e
  519.           Causes _l_e_s_s to open and interpret the named file  as  a
  520.           _l_e_s_s_k_e_y   (1)   file.    Multiple  -k  options  may  be
  521.           specified.  If a file called .less exists in the user's
  522.           home  directory,  this  file  is also used as a _l_e_s_s_k_e_y
  523.           file.
  524.  
  525.  
  526.                                                                 8
  527.  
  528.  
  529.  
  530.  
  531. LESS(1)             Unix Programmer's Manual              LESS(1)
  532.  
  533.  
  534.      -m   Causes _l_e_s_s to prompt verbosely (like _m_o_r_e),  with  the
  535.           percent into the file.  By default, _l_e_s_s prompts with a
  536.           colon.
  537.  
  538.      -M   Causes _l_e_s_s to prompt even more verbosely than _m_o_r_e.
  539.  
  540.      -n   Suppresses line numbers.   The  default  (to  use  line
  541.           numbers)  may  cause  _l_e_s_s  to  run more slowly in some
  542.           cases,  especially  with  a  very  large  input   file.
  543.           Suppressing  line  numbers  with the -n flag will avoid
  544.           this problem.   Using  line  numbers  means:  the  line
  545.           number  will  be displayed in the verbose prompt and in
  546.           the = command, and the v command will pass the  current
  547.           line  number  to the editor (see also the discussion of
  548.           LESSEDIT in PROMPTS below).
  549.  
  550.      -N   Causes a line number to be displayed at  the  beginning
  551.           of each line in the display.
  552.  
  553.      -o_f_i_l_e_n_a_m_e
  554.           Causes _l_e_s_s to copy its input to the named file  as  it
  555.           is being viewed.  This applies only when the input file
  556.           is a pipe, not an ordinary file.  If the  file  already
  557.           exists,   _l_e_s_s   will   ask   for  confirmation  before
  558.           overwriting it.
  559.  
  560.      -O_f_i_l_e_n_a_m_e
  561.           The -O option is like -o,  but  it  will  overwrite  an
  562.           existing file without asking for confirmation.
  563.  
  564.           If no log file  has  been  specified,  the  -o  and  -O
  565.           options  can  be used from within _l_e_s_s to specify a log
  566.           file.  Without a file name, they will simply report the
  567.           name of the log file.  The "s" command is equivalent to
  568.           specifying -o from within _l_e_s_s.
  569.  
  570.      -p_p_a_t_t_e_r_n
  571.           The -p option on the  command  line  is  equivalent  to
  572.           specifying  +/_p_a_t_t_e_r_n;  that is, it tells _l_e_s_s to start
  573.           at the first occurence of _p_a_t_t_e_r_n in the file.
  574.  
  575.      -P_p_r_o_m_p_t
  576.           Provides a way to tailor the  three  prompt  styles  to
  577.           your own preference.  This option would normally be put
  578.           in the LESS environment  variable,  rather  than  being
  579.           typed  in  with each _l_e_s_s command.  Such an option must
  580.           either be the last option in the LESS variable,  or  be
  581.           terminated  by  a dollar sign.  -P followed by a string
  582.           changes the default (short) prompt to that string.  -Pm
  583.           changes  the  medium (-m) prompt to the string, and -PM
  584.           changes the long (-M) prompt.  Also,  -P=  changes  the
  585.           message  printed  by the = command to the given string.
  586.           All prompt strings consist of a sequence of letters and
  587.           special  escape  sequences.  See the section on PROMPTS
  588.           for more details.
  589.  
  590.  
  591.  
  592.                                                                 9
  593.  
  594.  
  595.  
  596.  
  597. LESS(1)             Unix Programmer's Manual              LESS(1)
  598.  
  599.  
  600.      -q   Causes moderately "quiet" operation:  the terminal bell
  601.           is  not  rung  if an attempt is made to scroll past the
  602.           end of the file or before the beginning  of  the  file.
  603.           If  the  terminal  has  a  "visual  bell",  it  is used
  604.           instead.  The  bell  will  be  rung  on  certain  other
  605.           errors,  such  as  typing  an  invalid  character.  The
  606.           default is to ring the terminal bell in all such cases.
  607.  
  608.      -Q   Causes totally "quiet" operation:  the terminal bell is
  609.           never rung.
  610.  
  611.      -r   Causes "raw" control characters to be  displayed.   The
  612.           default  is  to  display  control  characters using the
  613.           caret notation; for example, a control-A (octal 001) is
  614.           displayed  as "^A".  Warning: when the -r flag is used,
  615.           _l_e_s_s cannot keep track of the actual appearance of  the
  616.           screen  (since  this depends on how the screen responds
  617.           to each type  of  control  character).   Thus,  various
  618.           display  problems  may result, such as long lines being
  619.           split in the wrong place.
  620.  
  621.      -s   Causes consecutive blank lines to be  squeezed  into  a
  622.           single  blank  line.  This is useful when viewing _n_r_o_f_f
  623.           output.
  624.  
  625.      -S   Causes lines longer than the screen width to be chopped
  626.           rather  than  folded.  That is, the remainder of a long
  627.           line is simply discarded.  The default is to fold  long
  628.           lines; that is, display the remainder on the next line.
  629.  
  630.      -t_t_a_g
  631.           The -t option, followed immediately by a TAG, will edit
  632.           the  file containing that tag.  For this to work, there
  633.           must be a file called "tags" in the current  directory,
  634.           which  was  previously  built by the _c_t_a_g_s (1) command.
  635.           This option may also  be  specified  from  within  _l_e_s_s
  636.           (using the - command) as a way of examining a new file.
  637.           The command ":t" is equivalent to  specifying  -t  from
  638.           within _l_e_s_s.
  639.  
  640.      -T_t_a_g_s_f_i_l_e
  641.           Specifies a tags file to be used instead of "tags".
  642.  
  643.      -u   Causes backspaces and carriage returns to be treated as
  644.           printable  characters;  that  is,  they are sent to the
  645.           terminal when they appear in the input.
  646.  
  647.      -U   Causes backspaces and carriage returns to be treated as
  648.           control  characters;  that  is,  they  are  handled  as
  649.           specified by the -r option.
  650.  
  651.           By default, if neither -u nor -U is  given,  backspaces
  652.           which  appear  adjacent  to an underscore character are
  653.           treated specially:  the underlined  text  is  displayed
  654.           using  the  terminal's hardware underlining capability.
  655.           Also, backspaces which  appear  between  two  identical
  656.  
  657.  
  658.                                                                10
  659.  
  660.  
  661.  
  662.  
  663. LESS(1)             Unix Programmer's Manual              LESS(1)
  664.  
  665.  
  666.           characters are treated specially: the  overstruck  text
  667.           is  printed  using  the  terminal's  hardware  boldface
  668.           capability.  Other backspaces are deleted,  along  with
  669.           the  preceding character.  Carriage returns immediately
  670.           followed by a  newline  are  deleted.   Other  carriage
  671.           returns are handled as specified by the -r option.
  672.  
  673.      -w   Causes blank lines to be used to represent  lines  past
  674.           the  end of the file.  By default, a tilde character is
  675.           used.
  676.  
  677.      -x_n  Sets tab stops every _n positions.  The default for _n is
  678.           8.
  679.  
  680.      -y_n  Specifies a maximum number of lines to scroll  forward.
  681.           If it is necessary to scroll forward more than _n lines,
  682.           the screen is repainted instead.  The -c or  -C  option
  683.           may  be  used  to repaint from the top of the screen if
  684.           desired.   By  default,  any  forward  movement  causes
  685.           scrolling.
  686.  
  687.      -[z]_n
  688.           Changes the default scrolling window size to  _n  lines.
  689.           The default is one screenful.  The z and w commands can
  690.           also be used to change the window size.  The "z" may be
  691.           omitted, as in "-_n" for compatibility with _m_o_r_e.
  692.  
  693.      +    If a command line option begins with +++,  the  remainder
  694.           of  that  option  is  taken to be an initial command to
  695.           _l_e_s_s. For example, +G tells _l_e_s_s to start at the end of
  696.           the  file rather than the beginning, and +/xyz tells it
  697.           to start at the first occurrence of "xyz" in the  file.
  698.           As a special case, +<number> acts like +<number>g; that
  699.           is, it starts the display at the specified line  number
  700.           (however,  see the caveat under the "g" command above).
  701.           If the option  starts  with  ++,  the  initial  command
  702.           applies  to every file being viewed, not just the first
  703.           one.  The + command described previously  may  also  be
  704.           used  to  set  (or change) an initial command for every
  705.           file.
  706.  
  707.  
  708. KKKEEEYYY BBBIIINNNDDDIIINNNGGGSSS
  709.      You may define your own _l_e_s_s commands by using  the  program
  710.      _l_e_s_s_k_e_y  (1)  to  create  a file called ".less" in your home
  711.      directory.  This file specifies a set of command keys and an
  712.      action  associated  with  each  key.  See the _l_e_s_s_k_e_y manual
  713.      page for more details.
  714.  
  715.  
  716. NNNAAATTTIIIOOONNNAAALLL CCCHHHAAARRRAAACCCTTTEEERRR SSSEEETTTSSS
  717.      There are three types of characters in the input file:
  718.  
  719.      normal characters
  720.           can be displayed directly to the screen.
  721.  
  722.  
  723.  
  724.                                                                11
  725.  
  726.  
  727.  
  728.  
  729. LESS(1)             Unix Programmer's Manual              LESS(1)
  730.  
  731.  
  732.      control characters
  733.           should not be displayed directly, but are  expected  to
  734.           be  found in ordinary text files (such as backspace and
  735.           tab).
  736.  
  737.      binary characters
  738.           cannot be displayed directly and are not expected to be
  739.           found in text files.
  740.  
  741.      By default, _l_e_s_s uses the ASCII character set.  In the ASCII
  742.      character  set,  characters  with values between 128 and 255
  743.      are treated as binary.  The LESSCHARSET environment variable
  744.      may  be  used to select another character set.  If it is set
  745.      to the value "latin1",  the  ISO  8859/1  character  set  is
  746.      assumed.   Latin-1  is  the same as ASCII, except characters
  747.      between 128 and 255 are treated as normal  characters.   The
  748.      only  valid values for LESSCHARSET currently are "ascii" and
  749.      "latin1".
  750.  
  751.      In special cases, it may be desired to tailor _l_e_s_s to use  a
  752.      character  set other than the ones definable by LESSCHARSET.
  753.      In this case, the environment variable  LESSCHARDEF  can  be
  754.      used  to  define  a  character  set.   It should be set to a
  755.      string where each character in  the  string  represents  one
  756.      character  in  the character set.  The character "." is used
  757.      for a normal character, "c" for control, and "b" for binary.
  758.      A  decimal  number may be used for repetition.  For example,
  759.      "bccc4b." would mean character 0 is binary, 1, 2 and  3  are
  760.      control,  4,  5,  6  and 7 are binary, and 8 is normal.  All
  761.      characters after the last are taken to be the  same  as  the
  762.      last, so characters 9 through 255 would be normal.  (This is
  763.      an example, and does  not  necessarily  represent  any  real
  764.      character set.)
  765.  
  766.      Setting LESSCHARDEF to  "8bcccbcc18b95.b"  is  the  same  as
  767.      setting  LESSCHARSET  to  "ascii".   Setting  LESSCHARDEF to
  768.      "8bcccbcc18b95.33b." is the same as setting  LESSCHARSET  to
  769.      "latin1".
  770.  
  771.      Control and binary  characters  are  displayed  in  blinking
  772.      mode.  Each such character is displayed in caret notation if
  773.      possible (e.g. ^A for control-A).  Caret  notation  is  used
  774.      only if inverting the 0100 bit results in a normal printable
  775.      character.  Otherwise, the  character  is  displayed  as  an
  776.      octal number preceded by a backslash.  This octal format can
  777.      be changed by setting the LESSBINFMT environment variable to
  778.      a  printf-style  format  string;  the default is '\%o'.  The
  779.      blinking mode display of control and binary  characters  can
  780.      be  changed  or  disabled by preceding the LESSBINFMT format
  781.      string with a "*" and one  character  to  select  the  mode:
  782.      "*k" is blinking, "*d" is bold, "*u" is underlined, and "*n"
  783.      is normal (no special display attribute).  For  example,  if
  784.      LESSBINFMT  is  "*u[%x]", binary characters are displayed in
  785.      underlined hexadecimal surrounded by brackets.
  786.  
  787.  
  788.  
  789.  
  790.                                                                12
  791.  
  792.  
  793.  
  794.  
  795. LESS(1)             Unix Programmer's Manual              LESS(1)
  796.  
  797.  
  798. PPPRRROOOMMMPPPTTTSSS
  799.      The -P option allows  you  to  tailor  the  prompt  to  your
  800.      preference.   The string given to the -P option replaces the
  801.      specified prompt string.  Certain characters in  the  string
  802.      are  interpreted  specially.  The prompt mechanism is rather
  803.      complicated to provide flexibility, but  the  ordinary  user
  804.      need not understand the details of constructing personalized
  805.      prompt strings.
  806.  
  807.      A percent sign followed by a single  character  is  expanded
  808.      according to what the following character is:
  809.  
  810.      %b_X  Replaced by the byte  offset  into  the  current  input
  811.           file.   The  b is followed by a single character (shown
  812.           as _X above) which specifies the line whose byte  offset
  813.           is  to  be  used.   If the character is a "t", the byte
  814.           offset of the top line in the display is used,  an  "m"
  815.           means  use  the middle line, a "b" means use the bottom
  816.           line, a "B" means use the line just  after  the  bottom
  817.           line,  and  a  "j"  means  use  the  "target"  line, as
  818.           specified by the -j option.
  819.  
  820.      %B   Replaced by the size of the current input file.
  821.  
  822.      %E   Replaced by the name of the  editor  (from  the  EDITOR
  823.           environment  variable).   See  the  discussion  of  the
  824.           LESSEDIT feature below.
  825.  
  826.      %f   Replaced by the name of the current input file.
  827.  
  828.      %i   Replaced by the index of the current file in  the  list
  829.           of input files.
  830.  
  831.      %l_X  Replaced by the line number of  a  line  in  the  input
  832.           file.   The  line to be used is determined by the _X, as
  833.           with the %b option.
  834.  
  835.      %L   Replaced by the line number of the  last  line  in  the
  836.           input file.
  837.  
  838.      %m   Replaced by the total number of input files.
  839.  
  840.      %p_X  Replaced by the percent into the  current  input  file.
  841.           The  line  used  is  determined by the _X as with the %b
  842.           option.
  843.  
  844.      %s   Same as %B.
  845.  
  846.      %t   Causes any trailing spaces to be removed.  Usually used
  847.           at the end of the string, but may appear anywhere.
  848.  
  849.      %x   Replaced by the name of the  next  input  file  in  the
  850.           list.
  851.  
  852.  
  853.  
  854.  
  855.  
  856.                                                                13
  857.  
  858.  
  859.  
  860.  
  861. LESS(1)             Unix Programmer's Manual              LESS(1)
  862.  
  863.  
  864.      If any item is unknown (for example, the file size if  input
  865.      is a pipe), a question mark is printed instead.
  866.  
  867.      The format of the prompt string can be changed depending  on
  868.      certain  conditions.   A  question mark followed by a single
  869.      character acts like an "IF":   depending  on  the  following
  870.      character,  a  condition  is evaluated.  If the condition is
  871.      true,  any  characters  following  the  question  mark   and
  872.      condition  character,  up  to  a period, are included in the
  873.      prompt.  If the condition is false, such characters are  not
  874.      included.   A  colon appearing between the question mark and
  875.      the  period  can  be  used  to  establish  an  "ELSE":   any
  876.      characters  between the colon and the period are included in
  877.      the string if  and  only  if  the  IF  condition  is  false.
  878.      Condition characters (which follow a question mark) may be:
  879.  
  880.      ?a   True if any characters have been included in the prompt
  881.           so far.
  882.  
  883.      ?b_X  True if the byte offset of the specified line is known.
  884.  
  885.      ?B   True if the size of current input file is known.
  886.  
  887.      ?e   True if at end-of-file.
  888.  
  889.      ?f   True if there is an input filename (that is,  if  input
  890.           is not a pipe).
  891.  
  892.      ?l_X  True if the line number of the specified line is known.
  893.  
  894.      ?L   True if the line number of the last line in the file is
  895.           known.
  896.  
  897.      ?m   True if there is more than one input file.
  898.  
  899.      ?n   True if this is the first prompt in a new input file.
  900.  
  901.      ?p_X  True if the percent into the current input file of  the
  902.           specified line is known.
  903.  
  904.      ?s   Same as "?B".
  905.  
  906.      ?x   True if there is a next input file  (that  is,  if  the
  907.           current input file is not the last one).
  908.  
  909.      Any characters other than the special ones  (question  mark,
  910.      colon, period, percent, and backslash) become literally part
  911.      of the  prompt.   Any  of  the  special  characters  may  be
  912.      included  in  the  prompt  literally  by preceding it with a
  913.      backslash.
  914.  
  915.      Some examples:
  916.  
  917.      ?f%f:Standard input.
  918.  
  919.      This prompt prints the filename,  if  known;  otherwise  the
  920.  
  921.  
  922.                                                                14
  923.  
  924.  
  925.  
  926.  
  927. LESS(1)             Unix Programmer's Manual              LESS(1)
  928.  
  929.  
  930.      string "Standard input".
  931.  
  932.      ?f%f .?ltLine %lt:?pt%pt\%:?btByte %bt:-...
  933.  
  934.      This  prompt  would  print  the  filename,  if  known.   The
  935.      filename is followed by the line number, if known, otherwise
  936.      the percent if known, otherwise the byte  offset  if  known.
  937.      Otherwise, a dash is printed.  Notice how each question mark
  938.      has a matching period, and  how  the  %  after  the  %pt  is
  939.      included literally by escaping it with a backslash.
  940.  
  941.      ?n?f%f\ .?m(file\  %i\  of\  %m)\  ..?e(END)\  ?x-\  Next\:\
  942.      %x..%t
  943.  
  944.      This prints the filename if this is the first  prompt  in  a
  945.      file, followed by the "file N of N" message if there is more
  946.      than one input file.  Then, if we are  at  end-of-file,  the
  947.      string  "(END)"  is printed followed by the name of the next
  948.      file, if there is one.  Finally,  any  trailing  spaces  are
  949.      truncated.  This is the default prompt.  For reference, here
  950.      are the defaults for  the  other  two  prompts  (-m  and  -M
  951.      respectively).   Each  is  broken  into  two  lines here for
  952.      readability only.
  953.  
  954.      ?n?f%f\ .?m(file\ %i\ of\ %m)\ ..?e(END)\ ?x-\ Next\:\ %x.:
  955.           ?pB%pB\%:byte\ %bB?s/%s...%t
  956.  
  957.      ?f%f\ .?n?m(file\ %i\ of\ %m)\ ..?ltline\ %lt?L/%L.\  :byte\
  958.      %bB?s/%s.\ .
  959.           ?e(END)\ ?x-\ Next\:\ %x.:?pB%pB\%..%t
  960.  
  961.      And here is the default message produced by the = command:
  962.  
  963.      ?f%f\ .?m(file\ %i\ of\ %m)\ .?ltline\ %lt?L/%L.\ .
  964.           byte\ %bB?s/%s.\ ?e(END)\ :?pB%pB\%..%t
  965.  
  966.      The prompt expansion features  are  also  used  for  another
  967.      purpose:  if an environment variable LESSEDIT is defined, it
  968.      is used as the command to be executed when the v command  is
  969.      invoked.  The LESSEDIT string is expanded in the same way as
  970.      the prompt strings.  The default value for LESSEDIT is:
  971.  
  972.           %E\ ?lm+%lm.\ %f
  973.  
  974.      Note that this expands to the editor name, followed by  a  +
  975.      and  the  line  number,  followed by the file name.  If your
  976.      editor does not accept  the  "+linenumber"  syntax,  or  has
  977.      other   differences   in  invocation  syntax,  the  LESSEDIT
  978.      variable can be changed to modify this default.
  979.  
  980.  
  981. EEENNNVVVIIIRRROOONNNMMMEEENNNTTT VVVAAARRRIIIAAABBBLLLEEESSS
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                                                15
  989.  
  990.  
  991.  
  992.  
  993. LESS(1)             Unix Programmer's Manual              LESS(1)
  994.  
  995.  
  996.      COLUMNS
  997.           Sets the  number  of  columns  on  the  screen.   Takes
  998.           precedence  over the number of columns specified by the
  999.           TERM variable.
  1000.  
  1001.      EDITOR
  1002.           The name of the editor (used for the v command).
  1003.  
  1004.      HOME Name of the user's home directory (used to find a .less
  1005.           file).
  1006.  
  1007.      LESS Flags which are passed to _l_e_s_s automatically.
  1008.  
  1009.      LESSBINFMT
  1010.           Format  for   displaying   non-printable,   non-control
  1011.           characters.
  1012.  
  1013.      LESSCHARDEF
  1014.           Defines a character set.
  1015.  
  1016.      LESSCHARSET
  1017.           Selects a predefined character set.
  1018.  
  1019.      LESSEDIT
  1020.           Editor prototype string (used for the v command).   See
  1021.           discussion under PROMPTS.
  1022.  
  1023.      LESSHELP
  1024.           Name of the help file.
  1025.  
  1026.      LINES
  1027.           Sets  the  number  of  lines  on  the  screen.    Takes
  1028.           precedence  over  the  number of lines specified by the
  1029.           TERM variable.
  1030.  
  1031.      SHELL
  1032.           The shell used to execute the ! command, as well as  to
  1033.           expand filenames.
  1034.  
  1035.      TERM The type of terminal on which _l_e_s_s is being run.
  1036.  
  1037.  
  1038. SSSEEEEEE AAALLLSSSOOO
  1039.      lesskey(1)
  1040.  
  1041.  
  1042. WWWAAARRRNNNIIINNNGGGSSS
  1043.      The = command and prompts (unless changed by -P) report  the
  1044.      line  number  of  the line at the top of the screen, but the
  1045.      byte and percent of the line at the bottom of the screen.
  1046.  
  1047.      If the :e command is used to name more than  one  file,  and
  1048.      one  of  the named files has been viewed previously, the new
  1049.      files may be entered into the list in an unexpected order.
  1050.  
  1051.  
  1052.  
  1053.  
  1054.                                                                16
  1055.  
  1056.  
  1057.  
  1058.  
  1059. LESS(1)             Unix Programmer's Manual              LESS(1)
  1060.  
  1061.  
  1062.      The handling of national character sets  is  nonstandard  as
  1063.      well  as  insufficient  for  multibyte  characters.  It will
  1064.      probably change in a later release.
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.                                                                17
  1121.  
  1122.  
  1123.